Section 9 - QUICK REFERENCE GUIDE 


COMMAND SUMMARY - The fof lowing list is a summary of commands. All commands issued 
from the local Keyboard must be preceeded by a Ctrl -A', (The only exception to 
this rule is to hangup while dialing or waiting for a di a I tone/carr i e r . > 


LOCAL eOhrWNDS 


FUNCTION 


Ctrt-A Ctr 1 -F 
Ctrl -A Ctr I -H 
Ctr i -A Ctrl " i 
Ctr I -A Ctr I -P 
Ctrl -A Ctr 1 -0 
Ctr I -A Ctrl-S 
Ctr 1 -A Ctrl-V 
Ctr 1 -A Ctrl-X 
Ctrl-A Ctrl-2 


Enter Terminal Mode in FULL duplex 
Enter Terminal Mode in HALF duplex 
Initialize Firmware to cold entry defaults 
Toggle Printer Buffer On/Off 
Init dialing (pickup phone in Voice mode) 

Transmit a BREAK until another char is sent 

Enter voice mode < turns off modem & turns on handset) 

Exit Terminal Mode (earner remains on) 

Hangup phone 


REMOTE COMMANDS FUNCTION 


Ctr 1 -N 
Ctr I -R 
Ctr I -S 
Ctr 1 -T 
Ctrl-Y 
Ctrl-2 


Xmit linefeed 4 CR delay to remote 

Exit terminal mode 

Stops transmission (any Key starts) 

Enter terminal mode 

En ter Mon t tor 

Hangup phone 


FIRMWARE -GENERATED MESSAGES - The Firmware outputs a message when it responds to a 
command or when a significant event has occured (i.e, Carrie*' found or lost*. All 
messages begin with the prefix *HGDEM:’ to let you Know where the message 
originated. What follows is a list of the various messages generated by the 
Firmware along with a brief description. 


BEGIN TERM 

CARRIER' 3 

CARR . OK 

DIALING 

DtALTGNE? 

END TERM 

INIT 

NO CARR, 
OFF-LINE 

ON-LINE 

RING 

TEftl 

VOICE 


Terminal mode entered 

Wait up to 45 seconds to receive valid earner 

Valid earner received 

Prompts user to enter phone number 

Wait up to 20 seconds for continuous audio tone 

Exit terminal mode & return to BASIC 

Firmware is rt-in i t i al i zed to Goldstar t defaults 

Carrier signal interrupted 

Phone is hungup 

Phone rs picked up 

Phone is ringing 

Signifies non -voice mode after dialing 
Modem tones turned off for voice commuri i cal i on 


Sw No. 

1 

2 

3 

4 


TABLE 1 - MINI -SWITCH SETTINGS 


ON 

Pulse Dialing 
110 Baud 
not used 

Pickup on 9th ring 


OFF 

Tone Di al mg 
300 Baud 
not used 

Pickup on 1st ring 
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NOTICE 


The Firmware is sold on an "AS IS“ basis. The purchaser assumes the entire risk of 
r ts operation. RAKH4ARE will in no event be held liable for di recti indirect,, or 
incidental damages including, but not limited to, any interruption of service, loss 
of business or anticipatory profits, or any other consequential damages. 

RAK-WARE reserves the right to make changes and improvements to the Firmware and/or 
documentation at any time without prior notification. 

The program (contained in the Firmware) and its documentation are copyrighted. You 
may not distribute copies of, or any part of, either this documentation or the 
program to others wr thou t specific approval from RAK-UARE. 


PR OP UCT /T RADEMARK ACKNOWLEDGMENT S 

Applesoft & Apple 11? Apple Computer Co. Apple-Cat II: Novation, Inc. 

M i cromodem II: Mayes M t crecomputer Products Videoterm: Vide* 

Full -View 05: 8i t3 Computer Corp. Smat term; Avanced Logic Systems 


Section 1 - INTRODUCTION 

The Firmware consists of a preprogrammed 2K byte read-on 1 y-memory (ROM) which 
physically resides on the Apple-Cat board. This Firmware contains a number of 
routines which instruct the modem without the need for additional software. In 
other words, it turns the Apple-Cat into a ' smart' board. 
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The Firmware has a command structure similar to Apple's Comnun i ca t i on Card and the 
Hayes Micromodem II. In fact, many of the commands have identical syntax and 
function. In addition, several new features have been added to make the Apple-Cat 
even more versatile. There are, of course, hardware differences between the 
Apple-Cat and the other modem cards which preclude 150/ i n terchangabi 1 i ty . Thus any 
existing applications program which reads or writes directly into control registers 
on those cards will probably not function correctly with the Apple-Cat without some 
modification. At the command level, however, there are ho significant differences. 

Here's a quick summary of features provided by the Firmware : 

* Three operational modes: Dumb Terminal, Remote Console & Programmable Modem, 

* Both PULSE and TONE dialing modes provided - switchable even while dialing. 

* Audible ring detect - your Apple actually 'rings' when receiving a call, 

* Rmg-back option permits multi -use of a single phone line. 

* True dial tone detection prevents premature dialing. 

* Supports 30 -column Cards and the M-wire' shift key modification.. 

* Built-in printer buffer minimizes lost data. 

* UOIDE mode permits direct verbal communication using Apple-Cat handset. 


Section 2 - INSTALLATION 

Installation of the F i rnware chip into the Apple-Cat board is relatively 
straight orward and shouldn't take more than ID minutes to perform. It does require, 
however , that adequate precautions be taken to prevent damaging the chip due to 
either mishandling or static electricity. Do not hesitate to seek professional help 
if you are hesitant about installing the Firmware yourself. Read over the following 
set of instructions first before proceed! ng wi th installation. 

Turnoff power to the Apple and remove the Apple-Cat board. Place the board on a 
flat surface with the electronic components facing up. Orient the board so that the 
slot contacts are facing you (the words 'NOTATION' should appear right Side up). 
Identify the empty Firmware socket which is located at the right end of the board. 
The word 'FIRMWARE appears Just under the socket. If your board already has 
something plugged into that socket, it must oe removed before proceeding. 

Since the Firmware can be damaged by static electricity, discharge yourself by 
momentarily touching a grounded metal surface. You can use your Apple's power 
supply case providing the Apple is plugged into a properly grounded 3-prong 
electrical outlet. Next remove the Firmware from its protective shipping wrapper 
and check to see that no pins art bent. Insert the Firmware into the Apple-Cat 
socket with a firm rocking motion until it is fully seated. The notch on the end of 
the Firmware should face to the left. 

Inspect the Firmware closely to verify that all pins are properly inserted into the 
socket . 

The Apple-Cat has a set of mi n i -sw i tches located vust below the phone line 
connection. These switches are used to set up several default conditions when the 
Firmware is initialized. For now, set all the switches down (OFF), If your phone 
line does not support tone dialing then set switch number 1 up (ON). 

Plug the Apple-Cat card back into your Apple, Although slot number 2 is preferred, 
it can be plugged into ary slot except slot number 0 (the left-most one). 
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Stct.pn 3 - DUMB TERMINAL MODE 


The Dumb Teritim*] Mode turns the Apple into a simple teletype terminal for 
cqmmun icat ion over <t standard voice-grade telephone link. Thi s mode is useful tor 
many types of activities such as communication with a tine-shared computer system, 
computer bulletin board or another Apple-Cat, 

A typical sequence of instructions to use this mode follows : 

U Turn-on and initialize Apple-Cat us itq an 'IN* (slot)' from BASIC or 
' <sl ot >Ctr 1 -K' from the Monitor, where <slot> is the slot number in which the 
Apple-Cat is installed. 

2. Enter Terminal Mode using a 'Ctrl -A CttJ-F' or the 'Ctrl -A Ctrl-H' contend 
sequence, ah is means that you must depress and hold down the CTRL key while typing 
the letter which follows.) The command you should use depends on whether the system 
you are dialing into operates in FULL or HALF Duple*, H you are not sure then type 

Ctrl -A Ctrl-H' (you can always switch ouer to full duple* later if you want to). 
(Notice, by the way, that all Firmware ccewiands issued from the keyboard consist of 
a 2 key command sequence where the first key is a Ctrl -A and the second key is a 
Firmware function code.) 

3. You can now use the Apple-Cat to dial the phone. Either pulse or tone dialing 
may be selected as the default dialing node by setting Switch II 1 located on the 
Apple-Cat board (see Table 1). 

a) Begin the dialing operation with a 'Ctrl -A Ctrl-0', There will then be a short 
pause while the Apple-Cat picks-up the phune to go on-line and waits for a 
dial tone . The Firmware will display the messages 'ON-LINE' and 'Dl ALT ONE' 1 ' to 
tell you what's happening. (If you are using the optional handset then you can 
I i fieri - 1 n on these activates.) Normally, it shouldn't take more than 3 to 4 
seconds for dial tone detection. If no dial tone is found within 20 seconds then 
there is probably something wrong and the Firmware will hangup the phone (the 
message 'OFF-LINE' will also be displayed). If, for example, you forgot to 
plug in the phone line and then realize it after waiting a few seconds* you can 
abort dialing by typing 'Ctrl-Z'. 

b> You can begin to enter the phone number to be dialed after the 'DIALING' 
message appears on the screen. You must wait until a digit is being dialed 
before another is entered. Remember that pu I se-di a! tnQ is much slower than 
tone-dialing, so that there may be a not i cable delay between entries. 

Only the digits 0 to 9, the letters T and P and the symbols 3 (for 3 second 
pause) and + (for add'l dial tone) are recognized (also * and It for tone 
dialing). All other characters are ignored, although they wi II be displayed on 
the screen. You can add spaces, slashes or dashes to help break up the phune 
number so that it is easy to read and check for typing errors. The dialing 
operation is ended by hitting ROUF&f after the last digit. If you should make 
an error while dialing and want to abort, Just hit 'Ctrl -2' (the Ctrl -A isn't 
required here). This hangs up the phone and exits the dialing operation. You 
must go back to step 3a to re-dial. 

c) The Firmware next turns off the handset and waits for the system you'ue called 
to answer the phone and return a earner tone (the message 'CARRIERS' is 
displayed). Since you've originated the call, the Apple-Cat has automatically 
been configured to ORIGIN and will only communicate with a system configured to 
ANSWER. If the phone is not answered or a carrier is not found within 45 
seconds then the Firmware hangs up the phone. You can exit from the 45 second 
wait at any time by typing 'Ctrl-Z'. 
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4. You get to this step only if a valid carrier tone has been received f'CARR. Or 
is displayed on the screen). You are now ready to log-on to the system you ve 
dialed into. Use the Apple just like a standard teletype. 

If the carrier signal from the other system is interrupted or turned off for any 
reason then the Firmware will detect th t s condi t i on and display the message NO 
CARR.'* If the carrier signal is not restored within l second then the phone is 
hungup. Avoid calling from phone lines which have the CALL-WAITING feature since 
this will interrupt communications if some one else is trying to reach you. 

5- Full or Half duple* operation can be toggled at any time by entering either a 
'Ctrl -A Ctrl-F or 'Ctrl -A Ctrl-H' respectively* So if you are seeing double 
characters on the screen during input, then switch from Half to Full duplex. On the 
other hand, if the characters you type do not appear on the screen, then switch from 
Fu I I to Half dup 1 ex . 

6 - Two separate methods can be used to toggle a printer on and off. If you have 
dumb parallel printer card in Slot *1 (like Apple s card for Cent ran i cs-type 

printer interfaces) you can use a special but 11- in routine which buffers several 
lines of data. This will minimize the problem of lost data discussed below. Just 
type 'Ctrl -A Ctrl-P' to toggle the printer on and off. A short beep tone will sound 
each time you use this command. 

Other printer configurations can be toggled on and off only from outside the 
Terminal Mode using the usual 'PRi<slot>' command, where (slot) is the printer 
interface card slot number. You can temporarily exit the Terminal Mode using a 
Ctrl -A Ctrl-X', then issue a PRKslot)' and return to the Terminal Mode using a 
'Ctrl -A Ctrl-f f or 'Ctrl -A Ctrl-H without disconnecting from the system with which 
you've established communications. 

Your printer must be able to print at least as fast as the data is being received or 
else information will be lost. Some printers do not initiate printing until a 
RETURN is received* and it may take a second or more to actually print the line and 
reposition the print head fur the next line. Again* information may be lost during 
this time* Most time -shared computer services* however, do have capab ility of 
accomodating hard-copy terminals which suffer from this very same problem. Usually 
the user has the abi I i ty to specify either a delay time or number of null characters 
Subsequent to RETURN and before the next line begins. This gives the printer 
adequate time to print so that no leading characters are lost. Refer to your 
time-shared computer systems manual for the proper cmrrand syntax. 

7, The Firewiar* lets you exit from the Dumb Terminal Mode and return to BASIC 
without di limbing the communications link (just type 'Ctrl-A CtrJ-X'>. You can use 
this feature, for example, to run an up/ down load program after you've logged on to 
your favorite timeshared computer system to transfer data. Use 'Ctrl-A Ctrl-F' or 
Ctrl -A Ctrl-H' to return back to Dumb Terminal Mode. 

B. After your session with the time-shared computer is completed and you've 
logged-off, type a 'Ctrl -A Ctrl-Z to hang up the phone <an OFF-LINE message will be 
displayed). You can either exit the Terminal Mode with a 'Ctrl-A Ctrl-X' or dial up 
another system by going back to Step 3. 

9. Even if you've exited the Dumb Terminal Mode, the Firmware is Still ■listening' 
for commands. You will have to type either INiO', 'OCtr I -K' or RESET to totally 
disconnect the Apple-Cat. 
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Sec t r grt 4 - REHOTE CONSOLE NOPE 


Th i v mode a Hows you to call your Apple from some remote location and make it 
perform just as if you were sitting in front of ft. AM hough you actually may be 
miies from your Apple, your remote keyboard functions Just like an Apple keyboard 
and your remote display functions Just like an Apple text screen < with the 
exception of pure cursor operations). This mode works either with or without DOS* 
With DOS active you can create, load, run and save files remotely. Here is a 
typical operational sequence: 

1. Turn-on the Apple -Cat by typing ' iff#<sl ot >' and 'PfttKsI ot , where (slot) is the 
number of the slot in which the Apple-Cat is installed. The order of these two 
commands isn't important. The Apple-Cat is now waiting for the phone to ring, 

2, When a call is rrcriued the Apple will toggle the speaker like a phone bell and 
display RING' on the screen. As the phone rings, the Firmware starts to count the 
number of ring-noring cycles and will pickup the phone when the required number of 
cycles is achieved. An option is provided to answer the phone either on the 1st 
ring or the ?th ring* This is selected by Switch # 4 on the Apple -Cat board (see 
Table I>. 

The Firmware employs a ring-back feature which is useful so that the phone line can 
be shared between an Apple operating ih the Remote Console mode and a standard 
telephone answering machine. With the Firmware set to pickup on the ?th ring and 
the answering machine set for pickup on the 4th ring, then the answering machine 
will always pickup first under normal circumstances. With the ring-back feature, 
however, you can have the Apple-Cat answer the phone by calling and letting it ring 
once. Then hangup and call again* The Apple-Cat will pickup on the first ring if 
you callback within 40 seconds of your initial call , 

3* Having picked up the phone, the Firmware next waits for a valid carrier to be 
received* The messages 'ON-LINE' and 'CARRIER' 3 ' are displayed to let you know 
what's happening. The caller must be in ORIGINATE mode since the Apple-Cat is in 
ANSWER mode. If a valid carrier is not received within 45 seconds of pickup then 
the Apple-Cat hangs up the phone ('OFF-LINE' is displayed). The Apple-Cat then 
patiently waits to answer the next call. 

4, Depending on which BASIC is active, either an Integer Sasic or Applesoft prompt 
is sent to the remote console to signify that you've been properly connected to your 
Apple# You can now use your Apple remotely* 

5, You may find that your remote console (e.g* CRT terminal or teletype) is 
displaying successive lines on top of one another. This is because it is not 
issuing a line feed after each RETURN is received from the Apple* There are two 
options that can be used to correct this problem. Most CRT terminals can be 
configered to generate an automatic line -feed after each RETURN, This may be a 
simple matter of setting an appropriate switch* Otherwise type a 'Ctrl-N' which 
tells the Firmware to start sending linefeeds. 

6, Another potential problem occurs with hardcopy terminals where the leading 
characters on a line are lost* This happens when the terminal is busy the end of 
the last line and repositioning the print head for the start of the next line. Type 
% 'Ctrl-N' to tell the Firmware that it should wait a short time after a RETURN 
before sending the next line (this command also causes linefeeds to be sent after 
each RETURN). The wait time defaults to 30 milliseconds (equivalent to one 
character at 300 Baud and about three characters at 110 Baud). You can easily 
increase this time to a maximum of 1.27 seconds by POKEing the number of 10 

mi lli-second delays into location 1528+SLGT* This value should not exceed 127, 
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like RESE^ 'bu7.lt Ctl i Y * C atop ctrta,rt operations. This ccmmand acts sortof 
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Gee 1 1 on 5 - PROGRAMMABLE MODEM 

This mode allows you to incorporate the various features of the Apple-Cat modem into 

p ^- The bas,c «-r 

BASIC Statement 


a> Answer the phone if it rings 

b) Receive characters from a remote system 

c) Dial a number (and wait for carrier) 

d) Send characters to remote system 

e) Hang up the phone 


IhMKslot) 

INPUT A* 

PRINT CHR*U7) jPHONEf 
RRINT Bt 
PRINT CHft*C2d) 


Inout n! 7 , P “i func 1 1 orrs whereas Items c.d and e are output functions. 

put and output functions are handled through the 'lN#<slot>' and 'PR»<slot>- 
c elands respectively. I nc an, ng characters are read via the INPLFT stat^ent.nd 
outgoing characters or Firmware commands are output u,a the PRINT statement, 

?! ° n F,rmwar ' f ’ w,th 4 ' PR *' xou can command the Apple-Cat 

P tf,a! a n ‘ ,n,t,ar ' ™ s 15 *>"• -ith a 'PRINT 

CHR*(17), 123-454, statement. You should determine whether or not a valid 
c ™ been estabtished before attempting to send data. This can be 

12^ and!! !" 9 IOC ‘ li ° n U5i+ELDrT - » ««'u. more than 

been .Itahl f!w 7 k ‘ 5 " 9 r * I * lua<J ' 0th «™i s « communication has not 

been estabt i shed ei then because the phone was not answered or the line was busy If 

toM ,s not * tt(r d,iMns «•" «• «p t£. 


completed your call a 'PRINT CHR*(24>' will hang up the phone. 

?rr!!Y IN ?h/rr d ,o t* th * Appi *- c *' m ° n "° r »>« *<*' m«. an d pick t( UP if 

!bov if a u fid * ClrM,r bx ,f5 ' in9 1OCt ' 0n SLOT as described 

INPUT ' or EFT “ Pr,Sfn ' ,htn d3U bt r — d either the 

7 i 7®°°i pra 7 l " to 4 'POKE 2O4O+SL0T ,0' statement at the beginn.ng of 

7 rf V T !k ,asijres ,ha * * ht F 1 rmware will Be initial iied tu C0LC startuo 
cond, ions when the ir.t 'PR#' or 'IN#' is executed. Subsequent command! to ?Jro 
'™ rf or ,out P ut functions will result in a WARM startup. (See 

Firmware Programing Beta, Is' for further details concerning r „ 1 1 a « , zat , on ) 
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Issuing 'pR# and "IN#-' commands from within BASIC program* must be done properly in 
order for them to work correctly. This mean* that if DOS is 'up' then the cemmand 
must appear in a PRINT statement and have been proceeded by a RETURN and Control -E*. 


(See your DOS Manual for further details. > 

Here i s an example Applesoft program which 
system and sends it a short message? 

LOO SL=2 
110 D*=CHftV:4> 

120 MD=i 656+ SL 
130 Ot=CHR1U7) 

140 Z*=CHR*<26> 

150 PN*=" [23-4567* 

160 Ml*-" THIS IS THE APPLE -CAT CALLING' 
170 N2*= ‘TESTING . A . *2 * .3* -TESTING* 

ISO M3*="BYE-6YE" 

190 POKE 2040 + SL ,0 
200 PR#SL 

210 PRINT Q*j 
220 PRINT PNt 

230 IF PEEK (MDM 128 THEN 900 
240 PRINT 
250 PRINT Hit 
260 PRINT H2* 

270 PRINT Hit 
280 GOSUB 600 LEND 

600 PRINT 2* 

610 INHOiPRHQ 
620 RETURN 

900 GOSUB 600 

930 PRINT" SYSTEM NOT AVAILABLE" 

920 END 


automatically dials another computer 


(APPLE -CAT IS IN SLOT M2) 
(COWTROL-D FDR DOS COMMANDS) 
(FIRMWARE "MODEM* REGISTER) 
(CTRL-Q TO START DIALING) 
(CTRL-2 TO HANGUP PHONE) 
(COMPUTER SYSTEM PHONE NO) 


(FORCE INITIALIZATION TO DEFAULTS) 
(TORN ON FIRMWARE) 

(USE PRINT D*i‘PR«*;SL IF DOS ACTIVE) 
(PICKUP PHONE) 

(DIAL M & WAIT FOR CARRIER) 

< GUTT IF NO ANSWER OR CARRIER) 

(SEND SYSTEM A RETURN) 

(SEND MESSAGE) 


(HANGUP PHONO 

(RESTORE NORMAL 1/0 FUNCTIONS) 


The foil owing segment waits for the phone to ring and accepts a short message: 

300 POKE 2040 + SL ,0 UNITIALIZE FIRMWARE) 

305 JNttSL : PRMSL (TU»1QN FIRMWARE) 

310 INPUT 'WAITING FOR CALL* i It 

320 IF PEEK <MD> <128 THEN 310 (LOOP IF HlffGUP) 

330 PR I NT * GK TO SEND A 3 LINE MESSAGE* 

340 PRINT 

350 FOR 1=1 TO 3:PRINT "LINE #*|I 
360 INPUT M*U) :NEXT I 
370 GOSUB 500 

380 INPUT" 1 S THAT CORRECT CY/NXjJt 

390 IF ltO‘Y* THEN 350 

400 PRINT'THANKS FDR CALLING* 

410 PRINT Zt (HANG UP) 

420 HOMEjFLASH 

430 PR I NT "MESSAGE RECEIVED" : NORMAL 
440 GOSUB 600: END 

500 PRINT :PRINT“ YOUR MESSAGE IS:" 

510 FOR J=1 TO 3: PRINT HSU) 

520 PRINT : RETURN 


example PROGRAM 


The following Applesoft program illustrates various techniques for programming the 
Apple -Cat through the Firmware, 

The purpose of the program is to automatically dialup and logon to the Telephone 
Software Connect ion , This software company distributes its programs right over the 
phone. Several programs are available at no charge (other than the telephone call) 
while others are paid for via charge card* 

It is assumed that the Apple^Cat is located in Slot #2* If it is not then change 
Line M35. After typing in the program then save it on diskette with the name "CALL 
TSC;AC" * Make sure that DOS is "UP and that there is an initial! red diskette in 
your drive before using CALL TSCiAC. 

(Program used with permission from TSG»> 

0 REM CALL TSCsAC 

J REM CALL TSC CO 1980 BY ED MAGNIN -ALL RIGHTS RESERVED- 

2 REM DISTRIBUTED BY: TELEPHONE SOFTWARE CONNECTION <TM> INC * 

P.O* BOX 6548, TORRANCE, CA 90504 
(21 3) 51 6- 9430: VOICE, (213)51 A-?432;M0DEM 

4 REH 10/14/81 

5 REM MODIFIED 7/26/82 FOR THE APPLE -CAT Id/FIfWWARE BY BOS KOVACS 

10 D*=CHRS ( 4 ) ; m= M TELEPHONE SOFTWARE C0FNECTI0N <TM> INC." 

P 29=* (21 3) 516-9432 24 HOUR MODEM* : DIM A(40) 

15 TEXT : HOME : INVERSE ; PRINT NS TABC21 -LEN(P2*)/2) 

P2S TA0( 4Q) * " : NORMAL : POKE 34,3 

20 REM — ~ 

25 REM INSERT CORRECT INFO: 

30 REM APPLE -CAT SLOT NO.: 

35 SLOT-2 

40 REM YOUR FIRST NAME : 

45 FM* JOHN" 

50 REM YOUR LAST NAME: 

55 LM'SMITH" 

60 REM YOUR PASSWORD: 

65 PW9= " PASSWORD " 

70 REM AREA CODE CALLING FROM: 

75 AC-213 

BO REM - - 

05 REM TSC PHONE NO. 

90 PH*=*1 “21 3-51 6-9432* 

95 IF ACs=21 3 THEN FhfMRt GHT* (PH* , 8) 

100 REM INSTRUCTIONS? 

110 IF PW9^" PASSWORD" THEN HOME S VTAB14 | 

PRINT "READ FOLLOWING DOCUMENTATION PRIOR TO RUMf ING . . . “ |CHR*< 7) : 

FOR 1=1 TO 1500 : NEXT J : GOTO 2000 

120 INPUT" DO YOU WANT INSTRUCTIONS? ";I9 I IF LEFT*( I* , 1 )=“ Y" THEN 2000 

130 REM 

200 REM DIAL TSC 

210 HOME : INPUT "WANT TO CALL NOW? " j 1% : IF LEFT*U t , I X>*Y" THEN 280 

220 D*=CHR*(4> : Q*=CHRVU7> : Z*»CHR*(26> : 

CHAR=1912 i SND^-16382 + 256 a SLOT : POKE 2040 + SLOT,0 
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230 HO HE : MINT D* * W * : PRINT D**| NiO" i PRINT 0**FRi*SLQT s 

PRINT i POKE 1912 * 5L » J 28 : REM POKE 129 FOR T(HE DIALING 

235 PRINT QtPMt 

240 PRINT C**PRiO" £ PRINT Df* INI* SLOT 

250 IF PEEK <1456 * SLOT) > 1 27 THEN 300 

2*0 PRINT Of “ IN*0 * : POKE -16368,0 

270 PRINT i PR I NT "NO ANSWER OR BUS* 1 : PRINT s 

INPUT "TRY AGAIN'? “ ; If i IF LEFTf (If , 1 )-■ Y* THEN 230 
280 PRINT Df*PR*0* i PRINT DflNiO* j POKE 34,0 
290 END 

295 REN 

300 REN LOG-ON 

310 POKE 1912 + SLOT ,] 28 

320 Of* “ F I RST NAME ? " i St-Ff : GOSUB 1000 * IF NOT FD THEN 320 

330 GOSUB 1100 : Of=“LAST NAML 1 * £ GOSUB 1000 s St~Lf : GOSUB 1100 

340 04*ft+ * "*Lt 1 INPUT * * ; I* ; INPUT " t IMRIGNT*< If ,LEN(Qf >) * 

Sf-"N“ { CT » (If * Of) * IF CT THEN S***Y - 
350 Of*" CORRECT ^ 1 t GOSUB 1000 i GOSUB 1100 
340 IF NOT C! THEN 320 

370 Of^ 1 PASSWORD t 1 I Sf*PWf : GGSUB 1000 : IF FO THEN GOSUB H00 : GOTO 380 

375 Of ^'NUMBERS?" i GOSUB 1000 : IF NOT FD THEN 375 

380 FLASH : PRINT s PRINT : PRINT : PRINT - "F**, TAKE OUER FRCH HERE * : 

NORMAL t POKE 1912 * SLOT ,138 
390 GET Af : END 

395 REN * 

1000 REM FIND OUEST1W 
1005 FD=0 i N=0 

1010 If^" i W»N+1 i IF N>20 THEN 1040 

1020 GET Af : PRINT ftfj i lt*lf*Af s FD*( RIGHTf ( If ,LEN(Qf > >*Of> i 

IF FD THEN 1040 

1030 IF At=CHRf < 1 3 i THEN 1010 
1035 GOTO 1020 
1040 RETURN 

1045 REM — 

1100 REM OUTPUT THRU MODEM 

11 LO S*LEN(Sf) : IfWERSE £ FOR J-l TO S j A( J )-ASC(MI D*< S* , J p 1 > ) : NEXT J 

1120 FOR 3-1 TO S i POKE CHAR ,A< J> j CALL SND 

1130 GET 8* t PRINT Bf; t NEXT J 

1140 NORMAL * POKE CHAR, 13 1 CALL 3^D t RETUfef 

1145 REM 

2000 REM INSTRUCTIONS 
2010 HONE : UTAB 8 

2020 PRINT # THIS PROGRAM AUTOMAT I DUX Y DIALS AND LOGS YOU 09 TO:* : PRINT 

2030 PRINT s PRINT "THE TELEPHONE SOFTWARE CEt^lECTION* : PRINT : PRINT 

2040 PRINT 'WHERE FULLY DOCUMENTED AND TESTED PROGRAMS FOR YOUR APPLE II 
COMPUTER ARE AS CLOSE AS YOUR MODEM" j PRINT ; PRINT 
2050 PRINT £ INPUT "NAME YOU INSERTED YOUR PERSONAL INFO? *;J* 

IF LEFTf (If P IH>*N" AND PWf < > - PASSWORD* THEN 200 
20*0 HCHE £ POKE 32 ( I i HTA0 5 s INVERSE ; 

PRINT - INSERT APPROPRIATE INFORMATION : - CHRf(7> i NORMAL : LIST 30,78 

2070 If*" CALL TCC:AC" i PRINT *l*ILOCKMf j PRINT *SAU€M* : 

PRINT -LOCK - If : PRINT *RlN - t PRINT i INVERSE I HTAB4 j 
PRINT “RIDE THRU EACH LIME WITH CURSOR* s NORMAL : POKE32.0 i VTA0 * 
2080 END 

2090 REM — 
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SfCt.pn 6 - MISCELLANEOUS NOTES 


SPECIAL KEt$ - The f o I ] cw i n,g keys have special meaning while in Terminal Modes 

*■=“ Send* a Backspace character 

Shift-Ctrl-M Sends a RUBOUT character 


DIALING (either Terminal Mode or from within a BASIC program) - The * symbol 
will search for another dial tone. The search can be aborted by typing a Ctrl-2 
(otherwise the phone will be hungup if no dial tone if found after 20 seconds)* The 
2 symbol produces a 3 second pause before the ne*t digit is dialed. The * and * 
Symbols are meaningful only during tone dialing. 

Use the mi m -ire* tches on the Apple-Cat board to setup the default dealing mode 
(either pulse or tone)* You can switch back and forth between these modes with a P 
(for Pulse) or T (for Tone) character as part of the phone number - 

It is passible to use the handset for voice communication after the Appli-Cat has 
dialed the number, While in Terminal Node this is done either by using the 'Ctrl -A 
Ctrl-M' command or by not hitting RETURN after typing in the phone number (use 
Ctrl-2 to hangup). From within a BASIC program just use a Linefeed character at the 
end of the phone number* PRINT CHRf ( J 7 > j * 1 23-4567" ; CHRf £ 1 9> , 


DP CQLlftf BOARDS - The firmware works with 80 column boards so you can d i sp 1 ay 
the majcimori amount of information on the screen while using your Apple-Cat- Turn, on 
both cards with the commands: PR* <80 column card slot) and IN*<App I e -Cat slot). 

The order of these commands is IMPORTANT and must not be reversed. This is because 
most 80 column cards effectively perform an IN* of their own, 

The Firmware f ul 1 y^ suppor ts the UIDEOTERM and FULL -Ml FW 80 cards. Other 80 column 
cards may work as well or with scree Imitations, The SMARTED t for exwnple, suffers 
from a missing cursor unless a small drtver program ts used to restore it. (AL& 
provides aft application note which describes a method to restore the cursor on their 
SMARTERM card,) 


L ODER -CASE DISPLAYS * The Firmware normally displays all inccmming data as 
uppercase characters* If your Apple can display lowercase characters because M has 
either a lowercase display 'chip' (like the Paymar lowercase adapter) or because you 
are using an 80 column board then it possible to disable the upper case conversion 
by POKE mg a 0 into location 1 704+51 0T* 


I -HI RE SHIFT KEY MOD - The Apple keyboard normally can input only uppercase 
characters. The popular 'l-wire shift key modi f i cat ion' is frequently used in 
program* like word processors to provide both upper and lower case characters. This 
modification has been described in several Usergroup newsletters and consists of a 
single wire from the shift key switch to Pin 4 (P02> of the Game I/O socket. 

If your Apple has this modification then is possible to send lowercase characters by 
POKE i ng 128 into location J520*SLOT, 


PpTEKTJAt TIMING PROBLEMS - It has been observed that not ill combinations o + 
Firmware (actually 2716 EPROMs) , Apple-Cats and Apple -Us work properly. This is 
apparent \y due to the effect of component tolerances on timing. The symptoms of a 
timing problem can range anywhere from the Firmware not seeming to work at all or 
seeming to work most of the time but occasionally getting 'hung . If you find this 
sort of thing happening on your system, it might easily be fixed by removing the 
Integrated Circuit labeled 28 tits a 74LS30) on the Appi e-Cat and replacing it with 
a 7430. This standard TTL device has a higher speed than the LS equivalent and is 
readily available from local electronics supply stores. We've found that changing 
this one component has solved most of the '‘timing' problems observed to date. 
(WAGING; This change may violate your Apple -Cat warranty.) 


Section 7 - APPLE-CAT vs CQTM CARD 

The following information is provided in an attempt to highlight the ma.ior 
differences between the Appl e-Cat and Apple's Communication Card* See Novation's 
'Advanced Programming Information' #800155 and Motorola's <5850 Data sheet for 
further details. 

The Apple-Cat is not directly compatable with either Apple's Communication Card or 
the Hayes M i cromodemi 11. This i nconpatab i 1 i ty stems from the Apple-Cat's assignment 
of certain hardware registers. Even though the Firmware makes the Apple-Cat respond 
to the same command strings and perform the same functions as these other modern 
cards* the Firmware CAWOT change either the Apple-Cat's hardware register addresses 
or their function. This is dictated solely by the Appl e-Cat' s circuitry. Why the 
designer's of the Apple-Cat chose to deviate from the Apple standard remains 
unc I ear . 

Many communications programs currently available for the Apple read and write 
directly to several hardware registers on the Comruin i cat i on ‘ s Card (or the 
Mi cromodem) . This is done to achieve fast reponse time and allow the program to 
perform more complex functions than are available on the modem card alone. The two 
most important registers are located within the 6850 ACIA (which stands for 
Asynchronous Communications interface Adapter). This device is used on both the 
Communications Card and the Mi cromodem but not the Apple-Cat. Their addresses and 
functions are summarized in the following table: 

ADDRESS READ WRITE 

♦COnE (1) 6850 Status 6850 Control 

♦COnF (2) 6850 Data Reev'd 6850 Data Xmit'd 

(1) also $C0nC for the Comm Card and *CGn6 for the Micromodem 

(2) also SCOnD for the Com Card and *CQn7 for the Micromodem 

NOTE: n in the addresses shown represent the card slot number plus 8. 


COWERS I ON TO APPL E-CAT - It is possible to convert programs which have been 
designed for use with Apple's Communication Card (or the Hayes Micromodem) to run on 
the App 1 e-Cat , First it is necessary to establish equivalences between the 6850 
registers and those in the Apple-Cat. The table on the following page lists these 
equivalences (if they exist). 


The next step involves program modification. This task could range anywhere from 
being relatively simple to next to impossible. It all depends on the program s 
design and security. 'Protected' disks, for example, will prevent access to the 
program, Pr ograms «r i t ten m BASIC are probably the easiest to change. Those 
written in machine code* on the other hand, must first be disassembled to determine 
where the registers are written to or read from. A very cooperative software 
company might even tell you what locations to modify! 


HARDWARE REGISTER EQUIVALENCES 


6850 REGISTER ADDRESSES <1? APPLE-CAT REGISTER ADDRESSES 


STATUS (read only) 





COnE, 

8 i t 

0: 

Receive Register Full (2) 

COnF , 

Bit 3 


COnE, 

Bit 

1 : 

Xmi t Register Empty 

CBnF , 

Git 4 


COnE , 

Bit 

2: 

Reset (No Carrier on till I) 

no eqi 

liu ( COnO , Bit 

5) 

COnE, 

Bit 

3: 

unused (Reset on tffll) 


— (no equiv) 


COnE, 

Bi t 

4; 

Framing Error 

COnF, 

Bit 6 


COnE, 

Bit 

5: 

Overrun Error 

COnF, 

Bit 7 


COnE , 

Bit 

6; 

Parity Error 

COnF , 

Bi t 5 


COnE, 

Bit 

7: 

IRQ 

COnF, 

Bit 0 = Ring 

IRQ 





COnF, 

Bit 1 * Recv 

IRQ 





COnF, 

Bit 2 ~ Xmi t 

IRQ 

CONTROL (wr i te on ! 

1 Y> 




COnE, 

Bi t 

0: 

Clock Divide Ratio 

(no equiv; 


COnE, 

Bit 

1: 

& Master ACJA reset 

(no equiv) 


COnE, 

Bit 

2> 

Word Select 

COnA s 

Bi tt 0 fc t - 

Word Length 

COnE, 

Git 

3: 

( H Data Bits, * Stop 

COnA, 

Bits 2 4- 3 ™ 

It Stop Si ts 

COnE, 

Bi t 

4: 

Bits 6 Parity) 

COnA, 

Bits 4,5 4 6 

= Far i ty 

COnE, 

Bit 

5: 

Xm j t Control 

COnC, 

Bi ts 2 If 3 


COnE, 

Bit 

6: 

(IRQ 6 Break) 




COnE, 

Bi t 

7: 

Recv IRQ 

COnC * 

Gits 0 6 I 



DATA RECEIVED (read ooty) 
COnFs Sits 0-7 

COnB : 

Bits 0 

- 7 

DATA TRANSMITTED (write only) 
COnF: Bits 0 - 7 

COnE: 

Bits 0 

- 7 


NOTES: 

(1) n - Slot number + 8 

(2) This bit is reset by reading the Data Received Register on the 685Q. On the 
Apple-Cat* however, the equivalent bit is reset by performing a write' to location 
♦CQnD. 


Section 8 - FIRHLttRE PRCGR^tilNG DETAILS 


fcpvT F: t F[: JNT^ - Tne“e are 4 srperate entry points into the Firmware as shown in 
the toll owing table: 


COLD Input/Output 
A1 ternate Warm Output 
WARM Output 
WARM input 


*Cr>0O - 49152 + 256* SLOT 
*Cnfi2 = 491 54 * 256*5LQT 
#Cn05 = 49157 4 256* SLOT 
*Cn07 * 49159 + 256*SL0T 


Following power-on, The COLD entry point is used by the FIRST character of an INPUT 
or PRINT statement following an IN*Kslot> or PRK<slot> command, where <slot> is the 
Apple-Cat slot number. Subsequent inputs and outputs are automatically sectored 
through the warm entry points. An alternate entry point is provided to allow for 
special outputs from within a BASIC program. This is accomplished by Poking the 
character into location 1912 and calling this alternate output address. For 
e x amp 1 e ■ 

Af^'ABCD 1 J $L0T=3 : SNO- 16382 4 256*$lQT 

FOR 1*1 TO LEW A*) : A=A SCIMID* (A* , 1 , 1 > > 

POKE 1 91 2, A : CALL SND s NEXT I 


INITIALIZATION - The first INPUT after the IN# (or PRINT after a PR#) performs a 
cold entry into the Firmware at *CnO0, where n is the slot number. Under certain 
circumstances this type of entry results in complete Firmware ini tial i ration. Among 
other things, initialization includes reading the m i n i -sw i tches in the Apple -Cat 
board, turning off the modem transmitter and hanging up the phone line. Like most 
other firmware on periphrrial cards, the input vector at #30,39 (or output vector at 
#36,37) is reset to the warm entry address. Thus subsequent inputs Cor outputs) 
bypass the in i t » a I i zat i on sequence. 

Whether or not the Firmware executes its initialization cycle depends on the RECBYT 
value (located at 2040+SLOT). If its value is anything other than the 2 valid ones 
(*E4 or *E5> then initialization is performed. Subsequent operat i ons wh i ch turn the 
card on and off will not result in initialization. It car easily be forced, 
however, with a "POKE 2O40+SLGT t O' prior to the next IN# or PR#, Initialization can 
also be performed with the 'Ctrl -A Ctr!~I' Firmware command, 

MEMORY USEAGE * In addition to the memory space that is allocated to the 
Apple-Cat slot <*Cn0[H*Cnf f , *C8D0-*CFFF) the Firmware also uses a number of other 
locations in RAM, 


Page Zero - Tone dialing uses *00 to *09 but those Vocations are not clobbered. The 
Monitor locations *24 (DO, *2B <BA$L> S and *36 to *39 (C3U/KSU) are used. 

Page Two - Used as a FIFO buffer while in Dumb Terminal mode. 

Common I/O Slot RAM - 


IMP! 

*478 = 

1 1 44 

T e mpor ary location 

THP2 

*4F8 = 

1272 


TMP3 

*578 - 

1400 


?? 

*5F8 - 

1 528 

(unass i ghed) 

77 

*678 - 

1656 

Cunassi gned) 

NO 

*6F8 - 

1784 

Slot number constant 

CHAR 

*778 = 

1912 

Data sent/received 

CN 

*7F0 = 

2040 

Slot number constant 


Slot dependent RAM - 


OUT.LP 

♦ 3BG 

♦ 

CN 

s 

1144 


N 

OUT .Hi 

*438 

t 

CN 


1272 


N 

XNTBYT 

*488 

+ 

CN 


HOG 

* 

N 

SHIFT 

*538 

* 

CN 

= 

1528 

* 

N 

CRDLf 

*538 

+ 

CN 

m 

1528 

4 

N 

MODEM 

*588 

* 

CN 


165o 

4 

N 

LOCSE 

*638 

4 

CN 


1784 

4 

N 

FLAGS 

*600 

t 

CN 

s= 

1912 

4 

N 

RECBYT 

*738 

+ 

CN 

- 

2040 

4 

N 


Current output - lobyte 
Device address ~ Hibyte 
Image of Xmtreg <*C08D ♦ NO) 

IHJire ShiftKey mod (B't 7 enables* 
No. of 10 Msec delays <127 max) 

See be 1 ow for de ta i I s 

LC -> UC (*2D enables , *00 disables; 

See below for details 

Image of Reereg (*C089 + WQ> 

(also used as initialization flag) 


MODEM {*563 4 *CN * 1656 4 N> 


87 

Hook 

0*0 n « 


i=0ff 

Hungup or picked up 

86 

Carr i er 

(Miff# 


l*0n 

Valid carrier indicator 

85 

undef i ned 

m 




04 

Buff 

0=CM*« 


l=0n 

Printer buffer control 

83 

undef i ned 





02 

Mode 

0*Ans# 


L*Grg 

Controls xmi t * reeu freq 

01 

Voice 

0-0n * 

Mff 

Communication or voice mode 

80 

Baud (Sw 2>* 

0^110 


1=300 

10 or 30 chars per second 

FLAGS <*689 * *CN - 1912 4 N> 





87 

Echo 

0=0 n « 


i*0ff 

Full /Ha If duplex 

86 

Dial i ngT 

0=No * 


I=Yes 

Dialing in progress 

85 

WRING (Sw 4)4 

0*1 St 


J=9th 

Number of rings before pickup 

04 

LFI 

0=Of 4* 


l*0n 

Xmit linefeed 6 delay 

63 

Term 

0=0ff+ 


l*0f» 

Terminal mode control bit 

02 

Tran 

0=0 f f * 


l*0n 

Transparent mode 

81 

Keyboard Enable 

0*No 

t*Yes# 


BQ 

Dial Mode (Sw I ) * 

0*Put se | 


1-Tone 




* COLD 

MIRY 

DEFAULTS 



Name 

Lee at i on 

1 

2 

Slot 

3 

‘ 4 

5 

6 

7 

OUT. 10 

1144+ SLOT 
*4 784 SLOT 

M45 

*479 

1146 

1147 

*470 

1148 

*47C 

1149 

*47D 

1158 

*47E 

M 51 
*47F 

OUT. HI 

1 2724 SLOT 
*4F8+ SLOT 

1273 
♦ 4F9 

1 274 
*4FA 

1275 

*4FB 

1276 

*4FC 

1277 

*4FD 

1273 

*4FE 

1279 

*4FF 

XMT8YT 

I40O+SLOT 
*578+ SLOT 

] 401 
*579 

1402 

*57A 

1403 

*578 

1404 

*57C 

1405 

*570 

1406 

♦57E 

1407 

*57F 

SH1FT/CRDLY 

1528+SLOT 

*5F0+SLQT 

1529 

*5F9 

153C 

*5FA 

p ,'pr-ji ) 

1531 

*5FB 

1532 

*5FC 

1533 

*5FD 

1534 

*5FE 

1535 

*5FF 

MODEM 

1 656+ SLOT 
*678+ SLOT 

1657 

*679 

1658 

*67A 

1659 

*678 

1660 

*67€ 

1661 

*67D 

1662 

*67E 

1663 

*67F 

LOCSE 

I 784+8L0 7 

*6F8*SL0T 

1785 

*6F9 

1786 

*6FA 

1787 

§6FB 

1788 
f 6FC 

1789 

*6FD 

1790 

*6F£ 

1791 

*6FF 

FLAGS 

191 2+ SLOT 
*708+$LGT 

1913 

*739 

1914 

*7flA 

1915 

*70B 

1916 

*78C 

1917 

*?8D 

1918 

*78E 

1919 

*78F 

RECBYT 

2040 + SLOT 
*7F8+SL0T 

2041 

*7F9 

2042 

*7FA 

2043 

*7F8 

2044 

*7FC 

2045 

*7F0 

2046 

*7F6 

2047 

*7FF 


